
Groupe de commandes "BTCH": Scnario 
====================================
(conu pour les scnarios)


/BTCH.BEEP.ONE ........: Emet un bip
/BTCH.BEEP.THREE ......: Emet trois bips
/BTCH.BEEP.HOUR .......: Emet le nombre de bips correspondant  l'heure 
------------------------ actuelle

Ces commandes sont utiles  la minuterie, dans laquelle elles mettront 
un signal correspondant  un moment prcis.
Voir le fichier-texte "Evnements" (Minuterie).

Exemple: bouton "A ou B" du profil "Dmo Taille et Go-Exit"


/BTCH.CR>TAB ..........: Remplace les retours  la ligne par des 
------------------------ tabulations  l'intrieur du scnario

Cette commande est utile pour remplir plus facilement des formulaires. En 
gnral il faut passer d'un champ  l'autre dans un formulaire (aussi sur 
Internet) avec la touche <Tab>. Ainsi c'est donc plus rapide par exemple 
d'introduire une entte de Word dans le scnario et de l'envoyer dans un 
formulaire, sans devoir passer par la touche Tab.

-> Attention !
Cette commande est en contradiction avec BTCH.EXPLICIT (voir ci-dessous).
Donc il est impossible d'avoir ces 2 commandes dans le mme scnario.
Il vaut mieux en cas de ncessit utiliser la commande ME.BUTTON  la fin 
du scnario pour appeler un autre bouton.

Exemple: {/BTCH.CR>TAB}


/BTCH.DDE.BEGIN .......: Inclu un scnario pour un autre bouton
/BTCH.DDE.END .........: Excute le scnario-DDE inclu
------------------------
Une description de la fonction DDE se trouve dans le fichier-texte 
"Travail en rseau" du sous-dossier "Network connection". 
Une fois que la fonction DDE dans la bote Prfrences et les paramtres 
du matriel (Hardware) sont rgls, on peut envoyer le scnario entre 
l'ordre de dbut (BEGIN) et de fin (END) soit dans l'ordinateur lui-mme, 
soit dans un rseau ferm.

Exemple de scnario (si vous n'avez pas de rseau) :

a) crez un bouton avec la commande : 
   {/BTCH.DDE.BEGIN}{/BTCH.MSG.TEXT Salut !}{/BTCH.DDE.END}
b) dmarrez RK une 2me fois pour avoir un 2me tableau, et placez-le  
   l'cran lgrement dcal au 1er
c) contrlez que la case "Connexion DDE" est coche
d) maintenant cliquez sur le bouton (l'un des 2) : 
e) le message "Salut !" est excut par le 2me tableau (puisqu'il se met 
   devant le 1er)


/BTCH.DELAY <sec> .......: Ajoute un dlai en seconde(s) <sec> avant 
-------------------------- d'envoyer des touches et commandes

Cette commande est trs importante, car il arrive souvent que RK travaille 
plus vite que les commandes envoyes  l'application concerne, de sorte 
que cela donnera des rsultats non dsirs. En plaant une petite pause 
dans le scnario, on permet au programme de terminer la partie du travail 
avant d'excuter les commandes suivantes.
Le paramtre-seconde donne la dure de pause en seconde, voir une valeur 
plus petite. Il est important que les dcimales soient prcdes d'un 
point et non d'une virgule (0.3 ou 1.5 etc.) !
Si vous changez de systme (ordinateur plus puissant), vous pouvez 
rduire les secondes, voir supprimer les commandes BTCH.DELAY.
L'enregistreur Macro se sert de ces commandes, lorsqu'on clique sur le 
bouton <Dlai + 1 sec.>. Une fois le scnario termin, on peut changer
les paramtres-seconde : en gnral en les rduisant.

Exemple: bouton "dplace" du profil "Stock


/BTCH.DIVERT>CLIP.ON ..: Dtourne l'envoi dans le presse-papiers, valide 
                         seulement pour le scnario actuel
/BTCH.DIVERT>CLIP.OFF .: Arrte le mode "divert" (dtourne)
------------------------

Cette commande permet d'envoyer dans le presse-papiers au lieu d'envoyer
dans l'application active.
La commande OFF n'est ncessaire que lorsque le dbut du scnario est 
envoy dans le presse-papiers et l'autre partie est envoye normalement.

Exemple: bouton "diffren." du profil "Stock"


/BTCH.EXIT-TAG ........: Sort du scnario  ce point
------------------------

Cette commande travaille avec les commandes GO ci-dessous.

Elle est aussi utile pour tester un long scnario qui ne fonctionne pas. 
En dplaant cette commande au fur et  mesure  l'intrieur du scnario, 
on dcouvrira finalement l'erreur.

Exemple: bouton "Ex - Go" du profil "Dmo Taille et Go-Exit"


/BTCH.EXITIF.ASK text .: Sort du scnario si "Non" a t cliqu dans la 
                         bote-message
/BTCH.EXITIF.CLIP text : Sort du scnario si le presse-papiers contient 
                         le <text> (commande au dbut du scnario)
/BTCH.EXITIF.VAR= v ...: Sort du scnario si VAR = valeur <v>
/BTCH.EXITIF.VAR> v ...: Sort du scnario si VAR > valeur <v>
/BTCH.EXITIF.VAR< v ...: Sort du scnario si VAR < valeur <v>
------------------------

Ces commandes travaillent comme la commande ci-dessous.

Exemples: plusieurs boutons du profil "Dmo Taille et Go-Exit"


/BTCH.EXITIF.CANCEL ...: Sort du scnario si "Ferme" a t cliqu dans la 
------------------------ dernire bote affiche

Cette commande est valide pour les commandes suivantes :

- BTCH.TEXT.ASK
- BTCH.TEXT.LIST.CLIP
- BTCH.TEXT.LIST.SEND
- CLIP.TXT.ASK
- CLIP.TXT.BEHND.ASK
- DAT.TEMP.ASK
- DB.OPEN
- DB.REC.SELECT
- DB.TABLE.ASK-S
- DB.TABLE.SELECT
- STR.ASK
- VAR.FLD.ASK

Exemple: bouton "Sl. & Envoie" du profil "Exemples de base de donnes"

         REC.SELECT affiche une liste de choix. Si celle-ci est ferme 
         avec "Ferme", la commande ne sera pas excute dans le scnario.

Exemples: bouton "quelle ?" (mmoire droite) du profil "Stock" 
          bouton "Ex - Cancel" du profil "Dmo Taille et Go-Exit"


/BTCH.EXPLICIT ........: Inscrit chaque commande dans une ligne unique
------------------------
Un scnario trs long parat d'une faon gnrale illisible, parce que 
les commandes sont colles les unes aux autres dans une seule ligne.
Pour obtenir des paragraphes lisibles, RK doit envoyer  ces endroits 
des "Retours  la ligne" (ENTER = ASCII 13) non dsirs.
La commande EXPLICIT, qui doit tre employe en premier dans le 
scnario, lie les Retours (ils ne seront pas utiliss dans le scnario), 
pour pouvoir insrer des lignes vierges. 
Si par contre un Retour est ncessaire pour le scnario, on peut alors 
l'insrer avec la commande KEY.ENTER.
C'est aussi possible d'envoyer directement avec la commande CODE.ASC 
les codes ASCII-13 (SHIFT+ENTER) et/ou ASCII-10 (CTRL+ENTER = saut de 
page).

Exemple: les boutons du profil "Dmo Taille et Go-Exit"

>>> Voir aussi l'exemple de scnario 1  la fin du document.


/BTCH.GO-TAG tag ......: Met un repre de saut <tag>
------------------------
Cette commande est requise pour toutes les commandes GO  dfinir, o il 
faut sauter.

Exemple: bouton "Go - To #7" du profil "Dmo Taille et Go-Exit"


/BTCH.GO.TO tag .......: Saute au repre <tag>
------------------------

Exemple: {/BTCH.GO.TO mon repre}

Le scnario sera continu  la place o {/BTCH.GO-TAG mon repre} sera 
trouv.

Combine avec la commande prcdente, elle est aussi utile pour tester un 
long scnario. En les dplaant  l'intrieur du scnario, on sautera des 
commandes qui sont peut-tre finalement inutiles.

Exemple: bouton "Go - To #7" du profil "Dmo Taille et Go-Exit"


/BTCH.GOIF.ASK txt,tag : Saute au repre <tag> si "Oui" a t cliqu dans 
                         la bote-message
/BTCH.GOIF.CANCEL tag .: Saute au repre <tag> si "Ferme" a t cliqu 
                         dans la dernire bote 
/BTCH.GOIF.CLIP txt,tag: Saute au repre <tag> si le presse-papiers 
                         contient le <text> (commande au dbut du 
                         scnario) 
/BTCH.GOIF.VAR= v,tag .: Saute au repre <tag> si VAR = valeur <v>
/BTCH.GOIF.VAR> v,tag .: Saute au repre <tag> si VAR > valeur <v>
/BTCH.GOIF.VAR< v,tag .: Saute au repre <tag> si VAR < valeur <v>
------------------------

Exemple:

{/BTCH.EXPLICIT}
{/BTCH.GOIF.ASK Voulez-vous le scnario B ?,essai}
{/ME.BUTTON Mon profil,Date}
{/BTCH.EXIT-TAG}
{/BTCH.GO-TAG essai}
{/ME.BUTTON Mon profil,Date,1}

En cliquant sur OK, la mmoire gauche du bouton Date sera excute.
En cliquant sur Ferme, la mmoire droite du bouton Date sera excute.

Exemples: plusieurs boutons du profil "Dmo Taille et Go-Exit"


/BTCH.INSTMODE.ON .....: Colle un texte avec CTRL+v directement au lieu 
                         de l'envoyer dans le presse-papiers
/BTCH.INSTMODE.OFF ....: Dsactive la fonction INSTMODE
------------------------ 
C'est une alternative trs rapide au mode de collage de Windows (CTRL+v) 
pour l'envoi normal de textes, particulirement recommande pour des 
passages trs longs.
On active la fonction INSTMODE au dbut du scnario et on la dsactive 
aprs avoir coll le texte. 
Dans la bote "Prfrences" on peut voir si elle est active (ON) ou non 
(OFF), mais elle ne peut tre rgle dans celle-ci.


/BTCH.LOOP.START.VAL no: Rpte la partie du scnario jusqu' la commande 
                         LOOP.END pour le nb. <no> de fois
/BTCH.LOOP.END ........: Marque la fin de la boucle
------------------------

Grce  la boucle le scnario qui se trouve entre la commande de dpart 
et de fin peut tre rpt.
Le paramtre <no> indique le nombre de boucles.

Exemple: bouton "heure 2" du profil "Stock"


/BTCH.LOOP.START.VAR no: Rpte la partie du scnario jusqu' la commande 
                         LOOP.END, le nb. <no> tant plus petit que la 
------------------------ variable <VAR>

Malgr la variable (VAR) la fin de la boucle est dfinie par l'ordre de 
fin. Mais la commande Variable offre la possibilit de choisir le nombre 
de boucles  l'aide d'une petite bote qui s'ouvre. 
La boucle est conue pour des nombres croissants.

>>> Voir l'exemple de scnario 1  la fin du document :

Dans cet exemple l'utilisateur peut choisir le nombre dsir de boucles 
avec la commande ASK (une petite bote s'ouvre) durant l'excution du 
scnario.
Comme un chiffre suprieur  0 ne fonctionne pas, on utilise une astuce 
dans laquelle le nombre d'abord ngatif (MUL -1) sera compt depuis 
lui-mme jusqu' 0.

Exemple: bouton "boucle 2" du profil "Stock"


/BTCH.MSG.AUTO sec ....: Ouvre une bote qui montre la date et l'heure 
                         pendant le nb de secondes choisi <sec>
/BTCH.MSG.TEXT text ...: Ouvre une bote qui montre le message <text>
/BTCH.MSG.TIME [text] .: Ouvre une bote qui montre le jour, la date, 
                         (n de semaine), l'heure, et un message 
------------------------ facultatif (les signes [] peuvent tre suppr.)

Ces commandes ont t conues pour tre utilises avec la minuterie, mais 
elles peuvent aussi l'tre autrement.
Le paramtre-seconde commande la dure qui gardera la fentre ouverte.
Le paramtre-texte affiche un texte; dans la 3me commande il est 
facultatif.

Exemple: bouton "heure 2" du profil "Stock"
Exemple: bouton "A ou B" du profil "Dmo Taille et Go-Exit"
Exemple: bouton "heure 1" du profil "Stock"

Exemple de scnario:

{/BTCH.MSG.AUTO 5}
{/BTCH.DELAY 4}
{/BTCH.MSG.TEXT Columbo est l...}
{/BTCH.MSG.TIME Le crime ne paie pas !}

--> Note
Essayez ce scnario de prfrence dans le Bureau (sans applications 
actives)


/BTCH.MSG.CLIP ........: Ouvre une petite bote qui affiche le texte
------------------------ inclu dans le presse-papiers

Exemple: {/BTCH.MSG.CLIP}


/BTCH.POP.OWN .........: Cre et affiche un menu contextuel personnel
------------------------
Cette commande permet de crer un menu contextuel personnel.
Elle possde une double fonction :

1. Elle cre la dfinition du menu dans le scnario.
2. Elle affiche le menu par un clic sur le bouton.

Dans le scnario on doit inscrire la commande d'excution immdiatement 
aprs le titre qui sera affich dans le menu contextuel.
On peut renoncer  la commande EXPLICIT car les commandes du scnario, 
comme dans l'exemple ci-dessous, sont crites les unes en dessous des 
autres.

Exemple de scnario:

{/BTCH.POP.OWN}

Affiche l'heure
{/ME.BUTTON Stock,heure 2}{/BTCH.BEEP.ONE}
Profils
{/ME.POP.PROF}

Ce scnario comprend 2 titres affichs dans le menu contextuel, 
"Affiche l'heure" et "Profils" qui sont suivis de leurs commandes.

Un autre exemple se trouve dans le bouton "me. pers" du profil "Stock".

En outre on peut faire apparatre un tel menu avec la fonction 
"Evnements > Raccourcis", et mme lorsque RK est cach dans la barre- 
systme.

--> Remarque
Depuis la version 8.1, chaque entre du menu peut tre dfinie avec 
plusieurs commandes.


/BTCH.REM text ........: 1. Inclu une remarque dans le scnario (n'est pas
                            excute) ou
                         2. Redonne l'activation  la dernire application 
------------------------    active (employe seule)

1. C'est donc utile pour ajouter une info dans le scnario.

   Exemple: {/BTCH.REM Le scnario n'est pas encore termin}
   Autre exemple : bouton "heure 2" du profil "Stock" 

ou

2. Cette commande peut aussi tre utilise pour redonner l'activation de 
   la fentre  la dernire application active, pour autant que RK ou 
   l'Explorateur du profil soit actif.

   Exemple: {/BTCH.REM text} 

   = seul dans le scnario


/BTCH.RETRIEVEFOCUS ...: Force RK  trouver la fentre active avant 
------------------------ d'envoyer la commande suivante

Dans des longs scnarios avec plusieurs fentres ouvertes, RK ne reconnait 
pas la fentre active actuelle, de sorte qu'il envoye la commande suivante 
de faon alatoire.
Cette commande force RK  trouver  nouveau la fentre active.

Un exemple, dans lequel cette commande est ncessaire, se trouve dans le 
profil "Stock" : bouton "Explorateur" (image).


/BTCH.SLOW <msec> .......: Ralentit en 1/1000 sec. l'excution du 
                           scnario (= Slow-Mode) / la fonction est 
-------------------------- dsactive  la fin avec <msec> = 0 

Lorsqu'il y a un nombre important de commandes BTCH.DELAY, le droulement 
du scnario est en gnral ralenti au point qu'il faut pouvoir rduire 
la dure des dlais.
De mme lorsqu'il y a beaucoup de situations critiques qui apparaissent 
tout le temps, on peut grce  cette commande ralentir tout le processus 
du scnario (mieux dans ce cas qu'avec BTCH.DELAY).
Avec le paramtre "msec" on rgle le retard en millimes de seconde.
A la fin du scnario on dsactive la fonction Slow-Mode en rglant le 
paramtre sur 0 (= {/BTCH.SLOW 0}). 
Dans la bote "Prfrences" on peut voir si la fonction est active (ON) 
ou non (OFF), mais elle ne peut tre rgle dans celle-ci.

Exemple: bouton "vitesse" du profil "Stock"  


/BTCH.STOP ............: Stoppe l'excution par un clic sur le bouton 
------------------------ STOP (= 1re commande du scnario !)

L'excution d'un scnario peut tre stopp avec cette commande. Elle est 
en particulier trs utile dans un scnario en boucle. 
Voir /BTCH.LOOP.START...(plus haut).
La commande doit tre place tout en haut du scnario !


Exemple: bouton "STOP" dans le profil "Stock"

>>> Voir aussi l'exemple de scnario 1  la fin du document : mais dans 
    ce cas le scnario est trop court pour avoir le temps de cliquer sur 
    le bouton STOP.


/BTCH.TEXT.ASK [qu,pre]: Colle un texte variable ( entrez dans une bote) 
------------------------ dans un module-texte envoy  une application
                         qu=question, pre=pr-rglage
4 possibilits :

{/BTCH.TEXT.ASK}
{/BTCH.TEXT.ASK Anne en cours}
{/BTCH.TEXT.ASK Anne en cours,2002}
{/BTCH.TEXT.ASK ,2002}

Exemple de scnario :

{/BTCH.EXPLICIT}
Je vous demande une rponse jusqu'au {/BTCH.TEXT.ASK S.v.p. entrez la 
date avec le format :,??.??.2002} et vous prie d'agrer...

Dans ce scnario une date (avec format requis) sera introduite au texte 
"Je vous demande..." envoy dans une application.
Quand cette commande arrive RK interrompt l'envoi et ouvre une bote, 
dans laquelle on entre la date (dans cet exemple). En cliquant sur OK 
(ou en pressant ENTER) elle est ajoute au texte puis finalement le 
reste du texte est envoy.

Bien sr cette commande peut tre rpte plusieurs fois dans un mme 
texte.
Les paramtres facultatifs <qu> et <pre> sont utiliss pour afficher dans 
une bote une requte (question) et/ou un texte prpar (pr-rglage).

Autre exemple: bouton " entrer" du profil "Stock"

--> Conseil
L'excution du scnario peut tre interrompue  l'aide de la commande 
"BTCH.EXITIF.CANCEL" si la bote est ferme avec le bouton "Ferme". 
(voir plus haut).


/BTCH.TEXT.LIST.CLIP ..: Copie un texte dans le presse-papiers, 
                         slectionn dans une liste qui est dfinie dans 
                         la mmoire 2 (bouton droit)
/BTCH.TEXT.LIST.SEND ..: Envoie un texte, slectionn dans une liste qui 
                         est dfinie dans la mmoire 2 (bouton droit)
------------------------
Ces commandes affichent une bote, dans laquelle l'utilisateur peut faire 
un choix, qui sera envoy (.SEND) ou copi dans le presse-papiers (.CLIP).
Elles ne peuvent tre assignes qu'avec la mmoire gauche du bouton, 
puisque dans la mmoire droite se trouve la liste de choix.

Exemple: bouton "env./liste" du profil "Stock"

--> Conseil
L'excution du scnario peut tre modifie  l'aide de la commande 
"BTCH.EXITIF.CANCEL" si la bote est ferme avec le bouton "Ferme". 
(voir plus haut).


/BTCH.WAIT.TOP title[,t] : Attend jusqu' ce que le titre <title> de la 
                           fentre vienne au premier-plan, <t> = pause en 
                           secondes 
/BTCH.WAIT.BACK title[,t]: Attend jusqu' ce que le titre <title> de la 
                           fentre aille  l'arrire-plan, <t> = pause en 
-------------------------- secondes
 
Ces commandes permettent de stopper l'excution d'un scnario jusqu' ce 
que la fentre spcifie apparaisse ou disparaisse. Avec le paramtre <t> 
(facultatif) on peut rgler la pause en secondes (si on ne choisit rien : 
<t> = 10 sec., valeur par dfaut).
Le paramtre empche peut-tre que RK tourne indfiniment.
Des jokers ("*") sont automatiquement ajouts au titre de la fentre et 
ainsi, il n'est pas utile de faire attention aux majuscules et minuscules.

Exemple: bouton "Explorateur" (image) du profil "Stock"


--------------------------------------------------------------------------

Exemple de scnario 1
=====================

{/BTCH.EXPLICIT}

{/BTCH.STOP}

{/VAR.ASK}
{/VAR.MUL -1}

{/BTCH.LOOP.START.VAR 0}
Essai{KEY.ENTER}
{/VAR.ADD 1}
{/BTCH.LOOP.END}
